home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / rtextu10.zip / HEAD.DOC < prev    next >
Text File  |  1993-05-06  |  3KB  |  79 lines
  1.  
  2.  
  3.                         #     #                        
  4.                         #     #  ######    ##    ##### 
  5.                         #     #  #        #  #   #    #
  6.                         #######  #####   #    #  #    #
  7.                         #     #  #       ######  #    #
  8.                         #     #  #       #    #  #    #
  9.                         #     #  ######  #    #  ##### 
  10.  
  11.  
  12.  
  13.  
  14. You can get part of the following documentation by invoking the program with
  15. the switches -v, -h, or -H . See README.TXT for more information.
  16.  
  17. -----------------------------------   -v   ------------------------------------
  18. HEAD v1.0 -- Show the first lines of text files
  19. Copr (c) 1992,1993 Richard Breuer. HEAD is freeware. No warranties.
  20.  
  21. This is HEAD/2 v1.0 - renamed to HEAD (from RUTILS 4).
  22.  
  23. Author: Richard Breuer
  24.         Brunssumstrasse 6
  25.         5100 Aachen
  26.         (after Jul 1, 1993: 52074 Aachen)
  27.         Germany
  28.         Europe
  29.  
  30. Phone:  +49/241/85605
  31. Fax:    +49/241/8021329
  32.  
  33. Email:  ricki@pool.informatik.rwth-aachen.de (Preferred!)
  34.  
  35. -----------------------------------   -h   ------------------------------------
  36. HEAD v1.0 -- Show the first lines of text files
  37. Copr (c) 1992,1993 Richard Breuer. HEAD is freeware. No warranties.
  38.  
  39. Usage:
  40.    HEAD [-hHqv*] [-<n>] infile.. [{>|>>} outfile]
  41.  
  42. Options:
  43.    -<n>  Display the first n lines. n must be non-negative. Default is n=10
  44.    -h    Display this help screen
  45.    -H    Display another help screen
  46.    -q    Supress the output of ==> filename <==, if multiple files are
  47.          processed
  48.    -v    Display version info
  49.    -*    Display internal information (for debugging purposes)
  50.  
  51. -----------------------------------   -H   ------------------------------------
  52. HEAD v1.0 -- Show the first lines of text files
  53. Copr (c) 1992,1993 Richard Breuer. HEAD is freeware. No warranties.
  54.  
  55. Notes:
  56.    HEAD reads from stdin if a filename is -. The output is always directed
  57.    to stdout. The line lengths are restricted to 255 characters. Longer lines
  58.    will be cut. The errorlevel is set to 1 if help has been displayed. It is
  59.    set to 255 in case of an error and 0 on normal completion. Output resulting
  60.    from multiple input files is appended to stdout. The processing order for
  61.    wildcards depends on the order of the directory entries. HEAD returns
  62.    nonsense for binary files.
  63.  
  64. Examples:
  65.    HEAD *.TXT
  66.       Process all *.TXT files in the current directory and append them to
  67.       stdout. The order is the one DOS's dir tells you.
  68.    DIR | HEAD -4
  69.       Display the first 4 lines of the directory.
  70.    HEAD HEADER.TXT - FOOTER.TXT
  71.       After processing HEADER.TXT the user must input text from the keyboard
  72.       until Ctrl/Z (=EOF) is detected. Then FOOTER.TXT is processed. All output
  73.       is appended on stdout.
  74.  
  75. -------------------------------------------------------------------------------
  76. Additional information:
  77.    HEAD is a re-implementation of the Unix command with the same name. One
  78.    minor difference is the -q option.
  79.